Set Up Data Distribution

To set up a data distribution (see also Data Distribution Over Several Installations), proceed in the following order.

Then carry out all IQ4docs installations (completely with MongoDB). When doing so, one installation should be defined as the main installation. Some of the data from this database are copied to all other databases (e.g. user data) and data from the other installations are merged into this database (e.g. accounting data).

Any existing installation can be used as the main installation. This installation must be completely updated. Proceed as follows in this case:

  • Create a backup of the database (see also Database Backup).
  • Uninstall MongoDB and RabbitMQ (e.g. with the Suite Installer).
  • Make an update of the system and install MongoDB and RabbitMQ with the current installer.
  • Restore the MongoDB backup (see also Database Backup).

Since the data status of the main installation overwrites parts of the data of the other installations, the data distribution should be set up in a new installation because otherwise data of the other installations will be lost.

A system area must now be created in the database of the main installation for each installation, see System Areas. Also enter the service for the data distribution here.

Now only make WebAdmin settings in the WebAdmin of the main installation.

The DBSyncService (performs the distribution of the data) is not included in the IQ4docs Installer Suite. The installation package must be obtained separately.

A DbSyncService is installed for each installation of a MongoDB server (i.e. for each cluster node in a 3-cluster installation). Carry out the installation after the installation of IQ4docs.

Follow the instructions of the installer on the screen.

Afterwards, the LocalService.config in the specified installation path of the DbSyncService must be filled with the necessary data:

  • MASTERDBHOST: Hostname of the main installation

  • REMOTEDBHOST: Hostname of the MongoDB server from and to which data are to be distributed. This is the parent server in the tree structure (for only a few installations, the hostname of the main installation can also be entered here - for large installations, data distribution should not be carried out directly to the main installation from every installation in order to relieve the load on the main installation).

  • INSTALLFOLDER: Location for the DbSyncService

  • USER: Name of the system user who is running the application pool of the DbSyncService.
  • PWD: Password of the system user.
  • CRYPTEDPWD: Password of the system user in encrypted form. This requires a separately available program.
  • DOMAIN: Domain in which the system user is located. This value can also be added to the system user in the USER parameter as a domain prefix or suffix.

In the main installation, the local hostname must be entered for the LocalDbHost, MasterDbHost and RemoteDbHost.

It is also possible to install the service automatically (silently).

For the DbSyncService installer, you have the following installation parameters:

  • MASTERDBHOST: Hostname of the main installation

  • REMOTEDBHOST: Hostname of the MongoDB server from and to which data are to be distributed. This is the parent server in the tree structure (for only a few installations, the hostname of the main installation can also be entered here - for large installations, data distribution should not be carried out directly to the main installation from every installation in order to relieve the load on the main installation).

  • INSTALLFOLDER: Location for the DbSyncService

  • USER: Name of the system user who is running the application pool of the DbSyncService.
  • PWD: Password of the system user.
  • CRYPTEDPWD: Password of the system user in encrypted form. This requires a separately available program.
  • DOMAIN: Domain in which the system user is located. This value can also be added to the system user in the USER parameter as a domain prefix or suffix.

Example:

msiexec /i IQ4docs-DbSyncService-4.11.5.0.msi /qn MyDomain.local CRYPTEDPWD=UlnrZaDFPTCtrj4KQgiqFP7GMvv1FMT50uex0tlhA20 INSTALLFOLDER="C:\IQ4docs 4\dbsyncservice\" MASTERDBHOST=server01 REMOTEDBHOST=server02

For the master server, the local hostname must be entered for MASTERDBHOST and REMOTEDBHOST .